*******************************************************************************

AS7343 EvalSw Software

*******************************************************************************

Thank you for choosing AS7343 Evaluation Board. 

For details in using the Eval Board please refer to the Users Guide included in the documents. 

If any technical difficulties are encountered, use the Tech Support page at www.ams.com/Support to submit a technical support request anytime or call ams sales FAE. 

You may also use www.ams.com to find worldwide local representatives in your area. 

Use the AS7343 setup to install all necessary software and driver on your Windows 10 based PC. 

Make sure, the following tools are installed on your PC:
1. Microsoft .NET Framework 4.5.2 (x86 and x64) (see directory DotNetFX452)
2. Visual C++ "14" Runtime Libraries (x86) (see directory vcredist_x86)
3. FTDI USB-MPSSE Cable Driver (see directory AS726x FTDI USB-MPSSE Cable Driver)

Please see in our manual for the details how the sensor board must be connected. All technical documents are in the directory Documents.




Please, note the following tips for the current release:

De-install former existing AS7343 Eval Kit software from your PC before installation and using the new setup. 

Make sure to use the new GUI and the standard initialization files only with a AS7343 Eval Kit without add-one IR-blocking.

Install the GUI at first before you copy (and replace) specific initialization files in the working directory.

The standard working directory for the GUI is C:\Users\xxxx\AppData\Roaming\ams-OSRAM\AS7343 EvalSw.

The GUI works with the Standard EVKs in combination with following initialization files:

1. init_file.txt - necessary for all GUI functions.
   It includes all-important values to control functions and limitations, e.g. sensor signal correction, light detection, reflective mode.
   We recommend making no changings in this file.

2. CM_L1_v1_0_0xxx.csv - includes the correction matrix for light detection.
   The matrix is a general solution and can be optimized by a matrix based on a device-to-device calibration.
   Note, a changing of the matrix can affect the sensor accuracy or following CIE1931 functions. The dimensions of the matrix determine
   direct following dimensions of alternative matrices and mask files.

3. CM_R_v1_0_0xxxxx.csv - includes the correction matrix for reflected mode as typical example. Several versions are included to show alternative 
   calibration methods. Note, calibration file must be adapted to the specific EVK to get acuracy. For more details, see (2.)

4. Mask_L_v1_0_0.csv - is a start mask file for spectral comparison. 
   It can be changed or created by the GUI. Do not use an older Mask file in combination with this new GUI. We recommend deleting older files.
   Use only the file that was installed by the GUI and/or make a new Mask file in combination with the actual correction matrix.

5. Mask_R_v1_0_0.csv - is a start mask file for reflected mode. For more details, see (4.)

After installation, connect the hardware via USB to PC. Place the sensor to a light source with a known spectrum.
Select TINT = 182ms and a values for gain to get highest signals for all channels before saturation.
Select an Application Specific Function like Light detection or Flicker to test the new functions for GUI.



For more details, please see the manuals or contact us.


*******************************************************************************

Version History

*******************************************************************************

Version     2.4.3
Date        14.06.2022

- Save offset / white balance values renamed to set
- Context menu entry write ini files moved down
- Warning added on writing ini files if offset / white balance values are set

*******************************************************************************

Version     2.4.2
Date        03.06.2022

- Wavelength values removed from spectrum plot x axis

*******************************************************************************

Version     2.4.1
Date        28.03.2022

- Script editor disable added
- Bug fix in script processing LED handling
- Bug fix max TInt changed to 46602

*******************************************************************************

Version     2.4.0
Date        03.03.2022

- Signed release version

*******************************************************************************

Version     2.3.4
Date        24.02.2022

- Temperature compensation file added to initialization file
- Temperature compensation file added to EEPROM
- Bug fix in measurement / dialog synchronization
- Bug fix in context menu handling
- Bug fix in EEPROM reinitialization

*******************************************************************************

Version     2.3.3
Date        15.02.2022

- In script processing communication error is ignored
- Bug fix in continuous measurement / script processing temperature measurement
- Bug fix in script processing command readTime
- Bug fix in ALS and flicker synchronization
- Bug fix in firmware update

*******************************************************************************

Version     2.3.2
Date        24.01.2022

- Max loop count in script processing changed to 100000

*******************************************************************************

Version     2.3.0
Date        08.12.2021

- Signed release version

*******************************************************************************

Version     2.2.2
Date        03.12.2021

- About dialog changed
- PAR and PPF added to logging

*******************************************************************************

Version     2.2.1
Date        29.11.2021

- PAR and PPF calculation added

*******************************************************************************

Version     2.2.0
Date        11.11.2021

- Signed release version
- Parallel measurement controlled by configuration file and GUI operation mode
- On parallel measurement enable default parameters are set
- Hot key Ctrl+U and script command for firmware update added
- Reconnect with last sensor after EEPROM change added
- Flicker removed from reflection app
- Bug fix in gain optimization
- Bug fix in thread management
- Bug fix in backside compensation
- Bug fix in script measurement

*******************************************************************************

Version     2.1.0
Date        09.09.2021

- Signed release version
- Chip lib support for version 1.1.2
- Features from version 1.22.0 added

*******************************************************************************

Version     2.0.5
Date        19.08.2021

- Chip lib support for version 1.0.1
- Goertzel algorithm for flicker detection added
- Features from version 1.21.5 added

*******************************************************************************

Version     2.0.4
Date        23.07.2021

- Chip lib support for version 0.6.3
- Features from version 1.21.4 added

*******************************************************************************

Version     2.0.3
Date        23.06.2021

- Changes to stabilize and increase robustness

*******************************************************************************

Version     2.0.2
Date        08.06.2021

- Chip lib support for version 0.6.2
- Name changed from AS7343 Demo to AS7343 EvalSw

*******************************************************************************

Version     2.0.1
Date        28.05.2021

- Chip lib support for version 0.6.1

*******************************************************************************

Version     2.0.0
Date        09.04.2021

- Chip lib support added

*******************************************************************************

Version     1.24.0
Date        11.11.2021

- Signed release version
- Reconnect with last sensor after EEPROM change added

*******************************************************************************

Version     1.23.0
Date        29.10.2021

- Signed release version
- Flicker removed from reflection app
- Bug fix in gain optimization
- Bug fix in thread management
- Bug fix in backside compensation
- Bug fix in script measurement

*******************************************************************************

Version     1.22.0
Date        09.09.2021

- Context menu for Ctrl commands added
- Hot key Ctrl+P for EEPROM reinitialization added

*******************************************************************************

Version     1.21.5
Date        06.08.2021

- Manufacturer name including folder names changed from ams AG to ams-OSRAM
- Bug fix in EEPROM data

*******************************************************************************

Version     1.21.4
Date        23.07.2021

- Global channel order added
- Calibration matrix correction values only used if set
- Local correction added to EEPROM
- Commands maxAutoGain and maxAutoTint added to script processing
- Saturation logging changed
- Gain min / max values used for auto gain

*******************************************************************************

Version     1.21.3
Date        15.07.2021

- Bug fix in offset measurement
- Auto gain calculation changed
- Spectrum dialog changed

*******************************************************************************

Version     1.21.1
Date        23.06.2021

- Spectral library version 1.2.1 used
- CCT value added to mask file
- Command writeLine added to script processing
- Command setComment added to script processing
- Commands beginLoop and endLoop added to script processing
- Command backSideComp added to script processing
- Bug fix in local correction

*******************************************************************************

Version     1.21.0
Date        21.05.2021

- Signed release version

*******************************************************************************

Version     1.20.12
Date        20.05.2021

- Bug fix in saturation handling

*******************************************************************************

Version     1.20.11
Date        19.05.2021

- Bug fix in spectrum and line graph dialog handling
- Bug fix in saturation handling

*******************************************************************************

Version     1.20.10
Date        19.05.2021

- Bug fix in EEPROM data reading

*******************************************************************************

Version     1.20.9
Date        18.05.2021

- Spectrum normalization changed
- Bug fix in correction gain handling
- Bug fix in spectrum dialog update
- MaxAutoGain handling changed
- Bug fix in saturation handling

*******************************************************************************

Version     1.20.8
Date        06.05.2021

- Integration time optimization changed

*******************************************************************************

Version     1.20.7
Date        06.05.2021

- Configuration of using low raw values for optimization added

*******************************************************************************

Version     1.20.6
Date        05.05.2021

- Bug fix in logging saturation handling
- Tracer command autoTint added

*******************************************************************************

Version     1.20.5
Date        04.05.2021

- Gain correction factor matrix EEPROM support added
- Max auto gain value handling changed

*******************************************************************************

Version     1.20.4
Date        29.04.2021

- Gain correction factor matrix added

*******************************************************************************

Version     1.20.3
Date        22.04.2021

- Display of estimated measurement time added
- Configuration of empty EEPROM dialog added
- Measurement thread added
- Tracer thread added

*******************************************************************************

Version     1.20.2
Date        13.04.2021

- Macros added to mask files
- Trace added to spectrum graphic
- Bug fix in EEPROM size detection
- Configuration of use of high gain values added
- Flouresence factor added
- Bug fix in flicker agc handling

*******************************************************************************

Version     1.20.1
Date        11.03.2021

- EEPROM size detection added
- Bug fix in mask file EEPROM handling

*******************************************************************************

Version     1.20.0
Date        09.03.2021

- Bug fix in gain optimization
- Display of F5 in spectrum graph can be selected

*******************************************************************************

Version     1.19.11
Date        22.02.2021

- Max auto gain set to 512x

*******************************************************************************

Version     1.19.10
Date        19.02.2021

- Signed release version

*******************************************************************************

Version     1.19.6
Date        17.02.2021

- VIS and NIR measurement configuration added

*******************************************************************************

Version     1.19.5
Date        16.02.2021

- Restart after EEPROM initialization and clear
- Reconnect after EEPROM disable
- Configuration of VIS / NIR in correction factor and offset added

*******************************************************************************

Version     1.19.4
Date        05.02.2021

- Gain trimming reset control via config file added
- Configuration of VIS / NIR in reflection calibration matrix added

*******************************************************************************

Version     1.19.3
Date        03.02.2021

- Clear renamed to VIS
- Configuration of VIS / NIR in calibration matrix added
- Bug fix in channel order (F8->F5,F5->F6,F6->F7,F7->F8)

*******************************************************************************

Version     1.19.2
Date        29.01.2021

- Bug fix in set gain function
- Bug fix in register map

*******************************************************************************

Version     1.19.1
Date        27.01.2021

- Gain values 2048, 4096, 5120 added
- Bug fix in set gain function
- Bug fix in continuous measurement
- Bug fix in spectrum graph x axis scaling

*******************************************************************************

Version     1.19.0
Date        21.01.2021

- AS7343 support added

*******************************************************************************
